home *** CD-ROM | disk | FTP | other *** search
/ Atari Mega Archive 1 / Atari Mega Archive - Volume 1.iso / printing / cdprnt15.arc / CDPRNT15.TXT next >
Text File  |  1992-04-01  |  6KB  |  154 lines
  1.                          Code Print v1.5
  2.                         =================
  3.  
  4.                        By  Kenneth Hartlen
  5.  
  6.                           March 24,1992
  7.  
  8.  
  9.      Code Print v1.5 prints a text file in two columns on a page. 
  10. The  first column will have lines 1 to 58 and the  second  column 
  11. will have lines 59 to 116. The top of each page has a header that 
  12. contains the filename,  date printed and page numbers. Code Print 
  13. v1.5 takes advantage of the 20cpi capability of the new printers, 
  14. like my Panasonic KX-P1124,  which allows 160 characters per line 
  15. on a narrow carriage printer.
  16.  
  17.      The main reason I wrote this program was to save paper  when 
  18. printing  source code during program debugging,  sample  programs 
  19. and for infrequently used documentation.
  20.  
  21.      Friends expressed an interest in this utility,  so I thought 
  22. I'd  share it with others.  I wrote the program in C and  the  ST 
  23. version was compiled using Lattice C v5.06 and the PC version was 
  24. compiled using Turbo C v2.0.
  25.  
  26.  
  27.                           CDPRNT15.ARC
  28.                          ==============
  29.  
  30.      The  archive file CDPRNT15.ARC contains the  required  files 
  31. for  using  Code Print v1.5 on an Atari ST or  an  PC  compatible 
  32. computer.
  33.  
  34. CODEPRNT.TTP   The ST version of the Code Print v1.5 program. Run 
  35.                from GEM, NeoDesk or a CLI.
  36. CODEPRNT.EXE   The PC version of the Code Print v1.5 program, run 
  37.                from MS-DOS.
  38. CODEPRNT.CFG   The printer configuration file.
  39. LQ2500.CFG     Configuration file for Epson LQ2500 printer.
  40. CDPRNT15.TXT   This file.
  41. CODEPRNT.NIC   NeoDesk v3.02 icon file containing an icon for the 
  42.                ST version of the Code Print v1.5 program.
  43.  
  44.      If any of these files are missing, the original CDPRNT15.ARC 
  45. file has be tampered with.  Please locate a complete CDPRNT15.ARC 
  46. file.  The .CFG files are used by both the ST and PC versions  of 
  47. Code Print v1.5.
  48.  
  49.  
  50.                            The Program
  51.                           =============
  52.  
  53.      To  run  the  program on  an  ST,  simply  double-click  the 
  54. CODEPRNT.TTP  icon  in GEM or NeoDesk.   Since the program  is  a 
  55. .TTP, you will be prompted for parameters. When run from a CLI on 
  56. a ST or from MS-DOS on a PC, you must specify the parameters. The 
  57. program usage is: codeprnt [-ldstn] file
  58.  
  59.      Here is a list of legal options:
  60.  
  61.        -l      use letter quality font        
  62.        -d      use draft quality font (*)
  63.        -s      suppress progress messages
  64.        -tn     user defined tab size of n=0..9 (* n=8)
  65.        file    user specified path and filename
  66.  
  67.      Note:     (*) indicates the default options used when  para-
  68.                meters are not specified.
  69.  
  70.      Code Print v1.5 will return one of three exit codes:
  71.  
  72.        0: the program terminated normally.
  73.       -1: an illegal parameter was encountered or the printer  is 
  74.           not ready. (Note: The PC version looks for a printer on 
  75.           the LPT1 port).
  76.      -33: the file was not found.
  77.  
  78.      When  printing a text file containing lines longer  than  80 
  79. characters,  Code Print v1.5 will use as many lines as  necessary 
  80. and will not truncate any line.  The -tn option was included  for 
  81. printing files with unusual tab settings. Code Print v1.5 substi-
  82. tutes  imbedded  tabs with spaces so the text  can  be  formatted 
  83. properly before printing. A tab setting of 8 is the default.
  84.  
  85.  
  86.                      The  Configuration File
  87.                     =========================
  88.  
  89.      Since each model of printer will have different setup codes, 
  90. the  Code  Print v1.5 program reads a configuration  file  called 
  91. CODEPRNT.CFG  which  must  contain the  control  codes  for  your 
  92. printer.  If  CODEPRNT.CFG  can not be found  then  Epson  LQ2500 
  93. defaults will be used. I've supplied a configuration file for the 
  94. Epson LQ2500 and you can easily create your own if necessary.
  95.  
  96.      The CODEPRNT.CFG file must have the following format and can 
  97. be modified using any text editor.
  98.  
  99. Line 1: Code Print Printer Configuration Codes, Epson LQ2500
  100. Line 2: 003 027 077 015                 /* 20cpi */
  101. Line 3: 003 027 120 001                 /* letter quality font */
  102. Line 4: 001 012                         /* printer form feed */
  103. Line 5: 002 027 064                     /* printer reset */
  104.  
  105. Line 1:   Simply holds a comment for your purposes and is ignored 
  106.           by the Code Print v1.5 program.
  107. Line 2-5: These lines contain the printer codes that your printer 
  108.           recognizes.  The  first number is the number of  values 
  109.           that follow. Then up to 10 control values, separated by 
  110.           spaces, will be read. Again a comment for your purposes 
  111.           at the end of the line is ignored.
  112.  
  113.      If  Code Print v1.5 is not changing the cpi setting on  your 
  114. printer,  check  to  make  sure  your printer is  set  so  it  is 
  115. accepting software control codes.
  116.  
  117.  
  118.                       Disclaimer and Notes
  119.                      ======================
  120.  
  121.      Code  Print v1.5 is FREEWARE,  meaning CDPRNT15.ARC  can  be 
  122. distributed  freely  (unmodified) and there is no cost to  own  a 
  123. copy.  Code Print v1.5 is provided AS IS.  I make no  warranties, 
  124. either expressed or implied,  with respect to the  software,  its 
  125. quality,  performance,  or  fitness.  I  will not be  liable  for 
  126. direct,  indirect,  or  consequential damages resulting from  any 
  127. defects in the software.
  128.  
  129.      Having  said the that,  I hope you find Code Print  v1.5  as 
  130. useful as I do.
  131.  
  132.      Now you won't waste as much precious (expensive) paper  when 
  133. debugging  that stubborn program,  reviewing sample  programs  or 
  134. printing endless pages of user documentation.
  135.  
  136.      Suggestions to improve Code Print v1.5,  or if any bugs  are 
  137. encountered,  or  if you'd like to send $ (yeah,  right!) can  be 
  138. reported to myself:
  139.  
  140.           Kenneth W. Hartlen
  141.           Box 37, Site 6, RR#3
  142.           Armdale, Nova Scotia
  143.           Canada B3L-4J3
  144.  
  145.      Please  send a self-addressed stamped envelope if you  would 
  146. like me to reply.
  147.  
  148.      I  can  also  be reached by  e-mail  (until  the  university 
  149. realizes I've graduated) at my Internet addresses:
  150.  
  151.           hartlenk@newton.ccs.tuns.ca
  152.      or   hartlenkw@watt.ccs.tuns.ca
  153.  
  154.